home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / u_man / cat1 / nds.z / nds
Encoding:
Text File  |  2002-10-03  |  10.8 KB  |  265 lines
  1.  
  2.  
  3.  
  4. nnnnddddssssdddd((((1111))))                                                                nnnnddddssssdddd((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ndsd - network dual-head software daemon
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      nnnnddddssssdddd [ -bg ] [ -master <_m_a_s_t_e_r-_m_a_c_h_i_n_e-_n_a_m_e:0.0> ] [ -slave <_s_l_a_v_e-
  13.      _m_a_c_h_i_n_e-_n_a_m_e:0.0> ] [ -slaveright ] [ -masterleft ] [ -usekeysym ]
  14.      [ -wait ]
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      The Networked Dual-head Software Daemon, _n_d_s_d, enables a machine with
  18.      ndsd software, the "slave" machine, to accept keyboard and mouse input
  19.      from another machine on the network (the "master" machine).  Conversely,
  20.      a "master" machine with ndsd software can also be used to control
  21.      applications on a remote "slave" machine.
  22.  
  23.      Various configuration options can be specified by command line options or
  24.      in the _n_d_s_d configuration file /_u_s_r/_n_d_s/_d_h__c_o_n_f_i_g.  Commands in the
  25.      configuration file will override any command line options.
  26.  
  27.      The _n_d_s_d command has the following options:
  28.  
  29.      ----bbbbgggg     Tells _n_d_s_d to fork itself and run in the background.  _n_d_s_d will
  30.              not fork until it has successfully connected to the slave
  31.              display, so scripts can use this option in situations that
  32.              require _n_d_s_d to be running before continuing (such as login
  33.              sessions).
  34.  
  35.      ----mmmmaaaasssstttteeeerrrr _m_a_s_t_e_r-_m_a_c_h_i_n_e-_n_a_m_e:0.0
  36.              Tells _n_d_s_d which machine on the network it should accept mouse
  37.              and keyboard commands from.  If no "master" machine is specified,
  38.              the value of the DISPLAY environment variable is used.
  39.  
  40.      ----mmmmaaaasssstttteeeerrrrlllleeeefffftttt
  41.              The same effect as ----ssssllllaaaavvvveeeerrrriiiigggghhhhtttt.  By default, the "slave" machine
  42.              screen is assumed to be to the left of the "master" machine
  43.              screen.  If this option is set, dragging the mouse off of the
  44.              left-had side of the "master" machine monitor will cause the
  45.              cursor to apperar on the right-most edge of the "slave" machine
  46.              screen.
  47.  
  48.      ----ssssllllaaaavvvveeee _s_l_a_v_e-_m_a_c_h_i_n_e-_n_a_m_e:0.0
  49.              Tells _n_d_s_d which machine on the network should passively accept
  50.              mouse and keyboard control from the "master".  The specified
  51.              screen and display must support the "XTEST" X server extension.
  52.              If no "slave" machine is specified, ":0.0" (the first local
  53.              display) is used.  If a null string is specified for the slave
  54.              display, the value of the DISPLAY environment variable is used.
  55.  
  56.      ----ssssllllaaaavvvveeeerrrriiiigggghhhhtttt
  57.              Indicates that the monitors of the two machines are positioned
  58.              such that the "slave" machine monitor, the machine running the
  59.              _n_d_s_d, is to right of the "master" machine monitor.  Dragging the
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. nnnnddddssssdddd((((1111))))                                                                nnnnddddssssdddd((((1111))))
  71.  
  72.  
  73.  
  74.              mouse off of the right-hand side of the "master" machine monitor
  75.              will cause the cursor to appear on the left-most edge of the
  76.              "slave" machine screen.
  77.  
  78.      ----uuuusssseeeekkkkeeeeyyyyssssyyyymmmm
  79.              If this option is specified, keycodes from the master machine
  80.              will be translated by the X server prior to being fed to the
  81.              slave machine server.  This option is necessary when the two
  82.              machines have different keycodes.  Indigo2, Indy, O2, OCTANE and
  83.              Oynx2 machines use PC compatible keyboards, different from
  84.              previous SGI machines which used a SGI proprietary keyboard.
  85.              This option should be used if an machine with a PC keyboard is to
  86.              a machine with an SGI keyboard.  This option may also allow the
  87.              master machine to be a non-SGI machine.  There is a slight
  88.              performance hit for using this option, so use it only if you need
  89.              to.
  90.  
  91.      ----wwwwaaaaiiiitttt   This option causes the nds daemon to wait until a window exists
  92.              on the slave display before creating any windows or processing
  93.              input.  It may be needed when nds is started from the
  94.              /_u_s_r/_l_i_b/_X_1_1/_x_d_m/_X_l_o_g_i_n file (see below) and used with the
  95.              standard _x_d_m(_1) login window.  It is not needed for the _c_l_o_g_i_n(_1)
  96.              login window, which is the default on SGI systems.  The _x_d_m
  97.              window may be used if _c_l_o_g_i_n is not installed or if the _c_h_k_c_o_n_f_i_g
  98.              option _v_i_s_u_a_l_l_o_g_i_n is off.
  99.  
  100.      ----ddddeeeebbbbuuuugggg  The debug option will run the nds daemon in the foreground and
  101.              print out diagnostic info, helpful if problems arise.
  102.  
  103.      All options may be placed in the file /_u_s_r/_n_d_s/_d_h__c_o_n_f_i_g, each item on a
  104.      separate line.  The header in this file shows the format of the file.
  105.  
  106. SSSSEEEETTTTUUUUPPPP
  107.      _n_d_s_d is installed disabled by default.  To enable it, provide a display
  108.      specification for the "master" machine in the /_u_s_r/_n_d_s/_d_h__c_o_n_f_i_g file and
  109.      issue the command:
  110.  
  111.           chkconfig nds on
  112.  
  113.      Perform these operations on the "slave" machine.  You should not enable
  114.      _n_d_s_d on the "master" machine.
  115.  
  116.      If a user wishes simply to have one keyboard on a desk to control two
  117.      systems, this can be accomplished by adding the following line to the
  118.      /_u_s_r/_l_i_b/_X_1_1/_x_d_m/_X_l_o_g_i_n file on the "slave" machine:
  119.  
  120.           /etc/init.d/nds start silent
  121.  
  122.      This will start _n_d_s_d whenever the server puts up the login screen,
  123.      allowing remote cursor and keyboard control upon successful login to the
  124.      "master" machine.  This command can be issued at any time to start up
  125.      _n_d_s_d as a background daemon process.  It uses the "-bg" option to ensure
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. nnnnddddssssdddd((((1111))))                                                                nnnnddddssssdddd((((1111))))
  137.  
  138.  
  139.  
  140.      that _n_d_s_d is up and connected to the slave display when it returns.
  141.  
  142.      If you run into problems, issue the command:
  143.  
  144.           /usr/nds/ndsd -debug
  145.  
  146.      This will cause _n_d_s_d to be run in the foreground and issue diagnostic
  147.      messages as to what it is doing.
  148.  
  149.      To disable _n_d_s, issue the command:
  150.  
  151.           chkconfig nds off
  152.  
  153.      to prevent the _n_d_s daemon from starting up again.  To stop the currently
  154.      running _n_d_s daemon, at the unix prompt type:
  155.  
  156.           /etc/init.d/nds stop
  157.  
  158.      and it will not restart until the _c_h_k_c_o_n_f_i_g flag is reset to _o_n.
  159.  
  160.      If the user wishes to have the machine more closely resemble a hardware
  161.      dual-head machine, running the _s_l_a_v_e__i_n_s_t_a_l_l script will configure the
  162.      machine to do so:
  163.  
  164.           su
  165.           cd /usr/nds/slave
  166.           slave_install install
  167.  
  168.      This will set up the machine so that none of the usual window
  169.      decorations, such as the _4_D_w_m _t_o_l_l_b_o_x, appear.  To undo these changes,
  170.      de-install the slave software by:
  171.  
  172.           su
  173.           cd /usr/nds/slave
  174.           slave_install remove
  175.  
  176.      This will restore the machine to its default behavior.  Once you run the
  177.      _s_l_a_v_e__i_n_s_t_a_l_l script, you won't be able to use the normal window manager
  178.      functions, so don't run it unless you are sure you want to do so.
  179.  
  180. CCCCAAAAVVVVEEEEAAAATTTTSSSS
  181.      The _n_d_s_d daemon allows for mouse and keyboard interaction between the two
  182.      displays, but provides no additional X server functionality. Application
  183.      software that wishes to take advantage of a second display should take
  184.      into account that each machine is running it's own X server and allocate
  185.      resources appropriately.
  186.  
  187.      Mouse and keyboard information is transferred between the _n_d_s_d daemon and
  188.      the "master" machine over the network connecting the two machines.
  189.      Unusally heavy network traffic can affect performance.  A dedicated
  190.      network between the two machines will give maximum performance, though
  191.      most networks have sufficient bandwidth for good performance.  The
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. nnnnddddssssdddd((((1111))))                                                                nnnnddddssssdddd((((1111))))
  203.  
  204.  
  205.  
  206.      "slave" and "master" machine should be on the same subnet, connections
  207.      through gateways between subnets can negatively impact performance,
  208.      though _n_d_s_d will work as long as the "slave" and "master" machines can
  209.      communicate.
  210.  
  211.      Applications that use _X_W_a_r_p_P_o_i_n_t_e_r(_3_X_1_1) to move the cursor between the
  212.      two displays may not function correctly. The _n_d_s_d maintains cursor
  213.      positions internally, _X_W_a_r_p_P_o_i_n_t_e_r() calls will not update any _n_d_s_d state
  214.      information.  Good X programming leaves pointer movement up to the user,
  215.      so applications should not generally call _X_W_a_r_p_P_o_i_n_t_e_r().
  216.  
  217.      The _n_d_s_d daemon controls cursor movement between the two displays by
  218.      monitoring the pixels at the edge of the two screens.  Applications which
  219.      need single pixel accuracy at the edge of the screen may have problems
  220.      when running _n_d_s_d as _n_d_s_d may jump the cursor to the other display when
  221.      the user does not wish this to happen.
  222.  
  223. FFFFIIIILLLLEEEESSSS
  224.      /_u_s_r/_n_d_s/_d_h__c_o_n_f_i_g       the ndsd configuration file
  225.  
  226. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  227.      chkconfig(1M), X(1), Xsgi(1), XWarpPointer(3X11), xdm(1), clogin(1)
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.